.TH E1432_E1431_DIFF 5 E1432
.SH NAME
e1432_e1431_diff \- Compares the E1431 and E1432 Host Interface Libraries
.IX e1432_e1431_diff(5) 5
.SH DESCRIPTION

This manual page documents some of the basic differences between the
E1431 and E1432 Host Interface libraries.  This should be helpful for
anyone porting an application that worked with the E1431.

Most functions in the E1431 library have a corresponding function in
the E1432 library which performs the same action.  However, all
functions, variables, typedefs, and defines start with e1432 instead
of e1431.  Many functions were added to the E1432 library that have no
corresponding function in the E1431 library.

Almost all E1432 functions have a first parameter of type E1432ID,
which is not present in the E1431 functions, which is used to identify
what set of hardware to talk to.  This is in addition to the channel
or group ID.  See the manual page on e1432_assign_channel_numbers for
more details.

In the E1431 library, the only type of channel that must be dealt with
is an input channel.  The channels are logically numbered 1 through M,
where M is the number of input channels.

In the E1432 library, it is more complicated, since an E1432 can have
different types of channels.  The three types of channels currently
available are input, source and tach/trigger channels.  Channel
numbers for each type of channel are numbered starting from one, so
there will be input channels 1 through M, source channels 1 through N,
and tach/trigger channels 1 through P, where M is the number of input
channels, N is the number of source channels, and P is the number of
tach/trigger channels.  See the manual pages
e1432_assign_channel_numbers, e1432_create_channel_group, and e1432_id
for more details.

Error numbers start at -1300 for E1432, rather than -1200 for E1431,
so that they don't overlap.

Error numbers are negative rather than positive.  This actually works
out the same because the E1431 library always returnes the negative of
the error number.

Obviously, low-level register and register bit definitions change
substantially.  In particular, bits in the status register that are
used to indicate the reason for an E1431 VME interrupt have been moved
to a different register.

.B "Changes to Functions"

e1432_create_channel_group does not inactivate other channels within
the modules that the channels are in.  It also does not preset the
channels in the new group.  It also turns on only input channels,
while source and tach channels are turned off.

e1432_set_auto_arm defaults to \fBE1432_AUTO_ARM\fR, rather than
\fBE1432_MANUAL_ARM\fR.

e1432_set_auto_trigger defaults to \fBE1432_AUTO_TRIGGER\fR, rather than
\fBE1432_MANUAL_TRIGGER\fR.

e1432_reset_lbus defaults to having the local bus NOT in reset, while
E1431 defaults to having the local bus in reset.

e1432_set_try_recover defaults to not trapping bus errors.

e1432_read_raw_data, e1432_read_float32_data, and
e1432_read_float64_data, all take an extra parameter called
\fIwhich\fR.

e1432_check_overloads checks only active channels in a group, when
given a group ID.  e1431_check_overloads checks all channels in the
group, whether active or not.  e1432_check_overloads replaces the
E1431 "adc" parameter with a "half" parameter.  This means that the
E1432 function \fIcan't\fR distinguish ADC overloads from other
differential overloads, but it also means that the E1432 function
\fIcan\fR tell when a channel is underranged.

The E1431 has the ability to set input ground path to floating or
grounded, using function \fIe1431_set_input_low\fR.  The E1432 can't
set this programmatically; instead this is set with a switch on the
breakout box that connects to the inputs.  So, there is no
\fIe1432_set_input_low\fR function, and the
\fIe1432_set_analog_input\fR function has one fewer parameters.

The E1431 has the ability to replay data through its digital filters.
The E1432 does not have this ability, so all functions relating to
this were removed: e1431_replay_data, e1431_replay_data_wanted,
e1431_get_replay_data_size, e1431_set_replay_data_size, and
e1431_init_replay.

.SH "SEE ALSO"
.na
e1432_assign_channel_numbers, e1432_check_overloads,
e1432_create_channel_group, e1432_id(5), e1432_set_auto_arm,
e1432_set_auto_trigger, e1432_set_try_recover, e1432_read_raw_data,
e1432_read_float32_data, e1432_read_float64_data,
e1432_set_analog_input
.ad
